home *** CD-ROM | disk | FTP | other *** search
-
-
-
- SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrrSSSSttttaaaatttteeee((((3333)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrrSSSSttttaaaatttteeee((((3333))))
-
-
-
- NNNNAAAAMMMMEEEE
- SLGetSpoolerState, SLSetSpoolerState - gets/sets the spooling system
- printing and queueing state
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- ####iiiinnnncccclllluuuuddddeeee <<<<ssssppppoooooooollll....hhhh>>>>
-
- iiiinnnntttt SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrrSSSSttttaaaatttteeee((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****pppprrrriiiinnnntttteeeerrrr,,,, iiiinnnntttt ffffuuuunnnnccccttttiiiioooonnnn,,,,
- iiiinnnntttt ****ssssttttaaaatttteeeepppp))));;;;
- iiiinnnntttt SSSSLLLLSSSSeeeettttSSSSppppoooooooolllleeeerrrrSSSSttttaaaatttteeee((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****pppprrrriiiinnnntttteeeerrrr,,,, iiiinnnntttt ffffuuuunnnnccccttttiiiioooonnnn,,,,
- iiiinnnntttt ssssttttaaaatttteeee))));;;;
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- Each printer (or class of printers in System V) is associated with a
- printer queue. This queue holds the jobs that have been submitted for
- printing. The jobs are fed one by one to the printer. The queue can be
- viewed as having a gate at each end. The gate at the front end of the
- queue controls whether jobs are sent to the printer. The gate at the back
- of the queue controls whether jobs are accepted into the queue for
- printing. The _S_L_S_e_t_S_p_o_o_l_e_r_S_t_a_t_e function controls the state of each of
- these queue gates. The _S_L_G_e_t_S_p_o_o_l_e_r_S_t_a_t_e function reports the current
- state of each gate.
-
- _p_r_i_n_t_e_r Specifies the printer whose spooler state is to be set or
- reported. If _p_r_i_n_t_e_r is specified as NNNNUUUULLLLLLLL, the default
- printer is used.
-
- _f_u_n_c_t_i_o_n Specifies which gate or spooling function is to be set or
- reported. If the value is SSSSLLLL____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG, the state of the
- printing gate is set or reported. If the value is
- SSSSLLLL____QQQQUUUUEEEEUUUUEEEEIIIINNNNGGGG, the state of the queue entry gate is set or
- reported.
-
- _s_t_a_t_e This value indicates the state to set for the spooling
- function specified by the _f_u_n_c_t_i_o_n parameter. The value is
- one of SSSSLLLL____EEEENNNNAAAABBBBLLLLEEEEDDDD or SSSSLLLL____DDDDIIIISSSSAAAABBBBLLLLEEEEDDDD.
-
- _s_t_a_t_e_p This value indicates the current state of the spooling
- function specified by the _f_u_n_c_t_i_o_n parameter. The value is
- one of SSSSLLLL____EEEENNNNAAAABBBBLLLLEEEEDDDD or SSSSLLLL____DDDDIIIISSSSAAAABBBBLLLLEEEEDDDD.
-
- RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
- 0 is returned if execution was successful. -1 is returned and _S_L_e_r_r_n_o is
- set if an execution error has occurred.
-
- EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
- _S_L_G_e_t_S_p_o_o_l_e_r_S_t_a_t_e and _S_L_S_e_t_S_p_o_o_l_e_r_S_t_a_t_e will fail under the following
- general circumstances.
-
-
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrrSSSSttttaaaatttteeee((((3333)))) IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo SSSSLLLLGGGGeeeettttSSSSppppoooooooolllleeeerrrrSSSSttttaaaatttteeee((((3333))))
-
-
-
- SL_ERR_FIND_SPOOLER An error occurred while attempting to determine
- the available printer spooling systems.
-
- SL_ERR_NO_SPOOLERS There are no printer spooling systems available.
-
-
- SL_ERR_NO_DEF_PRINTER There is no default printer registered with the
- printer spooling system.
-
- SL_ERR_SPOOLER_ERROR A printer spooling system error has occurred.
-
- SL_ERR_BAD_FUNCTION An invalid printer spooling function has been
- specified.
-
- SL_ERR_BAD_PRINTER_NAME The printer name specified is either an empty
- string (""), or a string consisting entirely of
- whitespace.
-
- In addition to the general failures above, _S_L_G_e_t_S_p_o_o_l_e_r_S_t_a_t_e will also
- fail under the following circumstances.
-
- SL_ERR_NO_STATE The printer spooling state could not be
- determined.
-
- In addition to the general failures above, _S_L_S_e_t_S_p_o_o_l_e_r_S_t_a_t_e will also
- fail under the following circumstances.
-
- SL_ERR_BAD_STATE An invalid printer spooling function state has
- been specified.
-
- SL_ERR_PRIVILEGE Super-user privilege is required to execute this
- function. System V permits certain functions to
- be executed with "lp" account privileges.
-
- NNNNOOOOTTTTEEEESSSS
- 1. If BSD is the current spooling system, super-user privilege is
- required to successfully call the _S_L_S_e_t_S_p_o_o_l_e_r_S_t_a_t_e function. If the
- current spooling system is System V, the queueing state can be
- changed if the caller's uid is either super-user or _l_p, and the
- printing state can be changed if the caller's euid is either super-
- user or _l_p.
-
- 2. Under the System V spooling system, it is an error to attempt to
- disable printing (SSSSLLLL____PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG function) for a printer class.
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- SLPerror(3), libspool(3), accept(1), reject(1), enable(1), disable(1),
- lpc(1M)
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-